home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 July: Mac OS SDK / Dev.CD Jul 00 SDK2.toast / Development Kits / Cross Platform / QuickTime 4.1.2 Windows SDK / ComponentIncludes / Sound.k.h < prev   
Encoding:
C/C++ Source or Header  |  2000-04-12  |  8.9 KB  |  225 lines  |  [TEXT/R*ch]
  1. /*
  2.      File:        Sound.k.h
  3.  
  4.      Contains:    Sound Manager Interfaces.
  5.  
  6.      Version:    Technology:    Sound Manager 3.3
  7.                  Release:    QuickTime 4.1
  8.  
  9.      Copyright:    © 1986-1999 by Apple Computer, Inc., all rights reserved
  10.  
  11.      Bugs?:        For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. #ifndef ___SOUND_K__
  18. #define ___SOUND_K__
  19.  
  20. #include <Sound.h>
  21.  
  22. #if CALL_NOT_IN_CARBON
  23. #endif
  24. #if CALL_NOT_IN_CARBON
  25. #endif
  26. #if CALL_NOT_IN_CARBON
  27. #endif
  28. #if OLDROUTINENAMES
  29. #endif
  30. #if TARGET_RT_LITTLE_ENDIAN
  31. #else
  32. #endif
  33. #if CALL_NOT_IN_CARBON
  34. #endif
  35. #if OLDROUTINENAMES
  36. #endif
  37. /*
  38.     Example usage:
  39.  
  40.         #define SOUNDCOMPONENT_BASENAME()    Fred
  41.         #define SOUNDCOMPONENT_GLOBALS()    FredGlobalsHandle
  42.         #include <Sound.k.h>
  43.  
  44.     To specify that your component implementation does not use globals, do not #define SOUNDCOMPONENT_GLOBALS
  45. */
  46. #ifdef SOUNDCOMPONENT_BASENAME
  47.     #ifndef SOUNDCOMPONENT_GLOBALS
  48.         #define SOUNDCOMPONENT_GLOBALS() 
  49.         #define ADD_SOUNDCOMPONENT_COMMA 
  50.     #else
  51.         #define ADD_SOUNDCOMPONENT_COMMA ,
  52.     #endif
  53.     #define SOUNDCOMPONENT_GLUE(a,b) a##b
  54.     #define SOUNDCOMPONENT_STRCAT(a,b) SOUNDCOMPONENT_GLUE(a,b)
  55.     #define ADD_SOUNDCOMPONENT_BASENAME(name) SOUNDCOMPONENT_STRCAT(SOUNDCOMPONENT_BASENAME(),name)
  56.  
  57.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(InitOutputDevice) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA long  actions);
  58.  
  59.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(SetSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, ComponentInstance  source);
  60.  
  61.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(GetSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, ComponentInstance * source);
  62.  
  63.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(GetSourceData) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundComponentDataPtr * sourceData);
  64.  
  65.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(SetOutput) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundComponentDataPtr  requested, SoundComponentDataPtr * actual);
  66.  
  67.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(AddSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource * sourceID);
  68.  
  69.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(RemoveSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID);
  70.  
  71.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(GetInfo) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, OSType  selector, void * infoPtr);
  72.  
  73.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(SetInfo) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, OSType  selector, void * infoPtr);
  74.  
  75.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(StartSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA short  count, SoundSource * sources);
  76.  
  77.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(StopSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA short  count, SoundSource * sources);
  78.  
  79.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(PauseSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA short  count, SoundSource * sources);
  80.  
  81.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(PlaySourceBuffer) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, SoundParamBlockPtr  pb, long  actions);
  82.  
  83.  
  84.     /* MixedMode ProcInfo constants for component calls */
  85.     enum {
  86.         uppSoundComponentInitOutputDeviceProcInfo = 0x000003F0,
  87.         uppSoundComponentSetSourceProcInfo = 0x00000FF0,
  88.         uppSoundComponentGetSourceProcInfo = 0x00000FF0,
  89.         uppSoundComponentGetSourceDataProcInfo = 0x000003F0,
  90.         uppSoundComponentSetOutputProcInfo = 0x00000FF0,
  91.         uppSoundComponentAddSourceProcInfo = 0x000003F0,
  92.         uppSoundComponentRemoveSourceProcInfo = 0x000003F0,
  93.         uppSoundComponentGetInfoProcInfo = 0x00003FF0,
  94.         uppSoundComponentSetInfoProcInfo = 0x00003FF0,
  95.         uppSoundComponentStartSourceProcInfo = 0x00000EF0,
  96.         uppSoundComponentStopSourceProcInfo = 0x00000EF0,
  97.         uppSoundComponentPauseSourceProcInfo = 0x00000EF0,
  98.         uppSoundComponentPlaySourceBufferProcInfo = 0x00003FF0
  99.     };
  100.  
  101. #endif    /* SOUNDCOMPONENT_BASENAME */
  102.  
  103. /*
  104.     Example usage:
  105.  
  106.         #define AUDIO_BASENAME()    Fred
  107.         #define AUDIO_GLOBALS()    FredGlobalsHandle
  108.         #include <Sound.k.h>
  109.  
  110.     To specify that your component implementation does not use globals, do not #define AUDIO_GLOBALS
  111. */
  112. #ifdef AUDIO_BASENAME
  113.     #ifndef AUDIO_GLOBALS
  114.         #define AUDIO_GLOBALS() 
  115.         #define ADD_AUDIO_COMMA 
  116.     #else
  117.         #define ADD_AUDIO_COMMA ,
  118.     #endif
  119.     #define AUDIO_GLUE(a,b) a##b
  120.     #define AUDIO_STRCAT(a,b) AUDIO_GLUE(a,b)
  121.     #define ADD_AUDIO_BASENAME(name) AUDIO_STRCAT(AUDIO_BASENAME(),name)
  122.  
  123.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetVolume) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, ShortFixed * volume);
  124.  
  125.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetVolume) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, ShortFixed  volume);
  126.  
  127.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetMute) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short * mute);
  128.  
  129.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetMute) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short  mute);
  130.  
  131.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetToDefaults) (AUDIO_GLOBALS());
  132.  
  133.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetInfo) (AUDIO_GLOBALS() ADD_AUDIO_COMMA AudioInfoPtr  info);
  134.  
  135.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetBass) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short * bass);
  136.  
  137.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetBass) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short  bass);
  138.  
  139.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetTreble) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short * Treble);
  140.  
  141.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetTreble) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short  Treble);
  142.  
  143.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetOutputDevice) (AUDIO_GLOBALS() ADD_AUDIO_COMMA Component * outputDevice);
  144.  
  145.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(MuteOnEvent) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  muteOnEvent);
  146.  
  147.  
  148.     /* MixedMode ProcInfo constants for component calls */
  149.     enum {
  150.         uppAudioGetVolumeProcInfo = 0x00000EF0,
  151.         uppAudioSetVolumeProcInfo = 0x00000AF0,
  152.         uppAudioGetMuteProcInfo = 0x00000EF0,
  153.         uppAudioSetMuteProcInfo = 0x00000AF0,
  154.         uppAudioSetToDefaultsProcInfo = 0x000000F0,
  155.         uppAudioGetInfoProcInfo = 0x000003F0,
  156.         uppAudioGetBassProcInfo = 0x00000EF0,
  157.         uppAudioSetBassProcInfo = 0x00000AF0,
  158.         uppAudioGetTrebleProcInfo = 0x00000EF0,
  159.         uppAudioSetTrebleProcInfo = 0x00000AF0,
  160.         uppAudioGetOutputDeviceProcInfo = 0x000003F0,
  161.         uppAudioMuteOnEventProcInfo = 0x000002F0
  162.     };
  163.  
  164. #endif    /* AUDIO_BASENAME */
  165.  
  166. #if !TARGET_OS_MAC
  167. /*
  168.     Example usage:
  169.  
  170.         #define SNDINPUT_BASENAME()    Fred
  171.         #define SNDINPUT_GLOBALS()    FredGlobalsHandle
  172.         #include <Sound.k.h>
  173.  
  174.     To specify that your component implementation does not use globals, do not #define SNDINPUT_GLOBALS
  175. */
  176. #ifdef SNDINPUT_BASENAME
  177.     #ifndef SNDINPUT_GLOBALS
  178.         #define SNDINPUT_GLOBALS() 
  179.         #define ADD_SNDINPUT_COMMA 
  180.     #else
  181.         #define ADD_SNDINPUT_COMMA ,
  182.     #endif
  183.     #define SNDINPUT_GLUE(a,b) a##b
  184.     #define SNDINPUT_STRCAT(a,b) SNDINPUT_GLUE(a,b)
  185.     #define ADD_SNDINPUT_BASENAME(name) SNDINPUT_STRCAT(SNDINPUT_BASENAME(),name)
  186.  
  187.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(ReadAsync) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA SndInputCmpParamPtr  SICParmPtr);
  188.  
  189.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(ReadSync) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA SndInputCmpParamPtr  SICParmPtr);
  190.  
  191.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(PauseRecording) (SNDINPUT_GLOBALS());
  192.  
  193.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(ResumeRecording) (SNDINPUT_GLOBALS());
  194.  
  195.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(StopRecording) (SNDINPUT_GLOBALS());
  196.  
  197.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(GetStatus) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA short * recordingStatus, unsigned long * totalSamplesToRecord, unsigned long * numberOfSamplesRecorded);
  198.  
  199.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(GetDeviceInfo) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA OSType  infoType, void * infoData);
  200.  
  201.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(SetDeviceInfo) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA OSType  infoType, void * infoData);
  202.  
  203.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(InitHardware) (SNDINPUT_GLOBALS());
  204.  
  205.  
  206.     /* MixedMode ProcInfo constants for component calls */
  207.     enum {
  208.         uppSndInputReadAsyncProcInfo = 0x000003F0,
  209.         uppSndInputReadSyncProcInfo = 0x000003F0,
  210.         uppSndInputPauseRecordingProcInfo = 0x000000F0,
  211.         uppSndInputResumeRecordingProcInfo = 0x000000F0,
  212.         uppSndInputStopRecordingProcInfo = 0x000000F0,
  213.         uppSndInputGetStatusProcInfo = 0x00003FF0,
  214.         uppSndInputGetDeviceInfoProcInfo = 0x00000FF0,
  215.         uppSndInputSetDeviceInfoProcInfo = 0x00000FF0,
  216.         uppSndInputInitHardwareProcInfo = 0x000000F0
  217.     };
  218.  
  219. #endif    /* SNDINPUT_BASENAME */
  220.  
  221. #endif
  222.  
  223. #endif /* ___SOUND_K__ */
  224.  
  225.